Skip to content

Update Orleans and Aspire integration documentation - #54201

Open
Meir017 wants to merge 2 commits into
dotnet:mainfrom
Meir017:patch-1
Open

Update Orleans and Aspire integration documentation#54201
Meir017 wants to merge 2 commits into
dotnet:mainfrom
Meir017:patch-1

Conversation

@Meir017

@Meir017 Meir017 commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

.NET Aspire -> Aspire

Summary

FYI @IEvangelist @davidfowl

Copilot AI review requested due to automatic review settings June 7, 2026 11:23
@dotnetrepoman dotnetrepoman Bot added this to the June 2026 milestone Jun 7, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the Orleans hosting documentation to reflect “Aspire” (vs “.NET Aspire”) terminology and refreshes related setup links.

Changes:

  • Renamed headings/front-matter to “Orleans and Aspire integration”.
  • Updated external/reference links (aspire.dev, VS Code extension link).
  • Adjusted wording in pivoted sections to use “Aspire” terminology.

Comment thread docs/orleans/host/aspire-integration.md
Comment thread docs/orleans/host/aspire-integration.md
Comment thread docs/orleans/host/aspire-integration.md
Comment thread docs/orleans/host/aspire-integration.md
Comment thread docs/orleans/host/aspire-integration.md
Comment thread docs/orleans/host/aspire-integration.md Outdated
Comment thread docs/orleans/host/aspire-integration.md Outdated
@dotnet-policy-service dotnet-policy-service Bot added the community-contribution Indicates PR is created by someone from the .NET community. label Jun 7, 2026
@MatveevichOne

Copy link
Copy Markdown

@Meir017, I agree with the Copilot suggestions. Here are the issues and fixes:

Issue 1: Branding inconsistency
The document uses "Aspire" instead of the official product name ".NET Aspire" in:

  • Title: "Orleans and Aspire integration" → should be "Orleans and .NET Aspire integration"
  • Description: same fix
  • H1: same fix
  • Throughout the body text

Fix: Keep ".NET Aspire" as the primary name throughout the document. If shorthand is needed, add "(Aspire)" after first mention, e.g., ".NET Aspire (hereafter referred to as Aspire)".

Issue 2: External links vs internal links
The PR replaces Microsoft Learn links (/dotnet/aspire/...) with external aspire.dev links.

Fix: Restore the Microsoft Learn links for consistency, localization, and long-term stability. Use aspire.dev only for content that doesn't exist on Microsoft Learn.

Issue 3: Capitalization
Line 31: "Aspire cli" → should be "Aspire CLI"

Issue 4: Mixed terminology in pivot section
Line 209: "Aspire integration... .NET Aspire" → should be consistently ".NET Aspire" throughout.

Summary of changes needed:

| Title | "Orleans and Aspire integration" | "Orleans and .NET Aspire integration" |
| Description | "...with Aspire" | "...with .NET Aspire" |
| H1 | "# Orleans and Aspire integration" | "# Orleans and .NET Aspire integration" |
| Line 13 | "Aspire" | ".NET Aspire" |
| Line 17 | "Orleans integration with Aspire" | "Orleans integration with .NET Aspire" |
| Line 31 | "Aspire cli" | "Aspire CLI" |
| Line 209 | "Aspire integration... .NET Aspire" | ".NET Aspire integration... .NET Aspire" |

I can help create a PR with these fixes if needed.

@davidfowl

Copy link
Copy Markdown
Member

The official name is Aspire, not .NET Aspire

@ReubenBond

Copy link
Copy Markdown
Member

@copilot resolve the merge conflicts in this pull request

@ReubenBond
ReubenBond enabled auto-merge (squash) July 27, 2026 20:01
Co-authored-by: Genevieve Warren <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

community-contribution Indicates PR is created by someone from the .NET community.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants